home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 1 / Cream of the Crop 1.iso / MONITOR / STARSAVE.ARJ / STARSAVE.TXT < prev   
Text File  |  1991-03-04  |  7KB  |  184 lines
  1.  
  2.  
  3.  
  4.                      StarSaver, a Windows 3.0 Screen Saver
  5.                                By Duane T. Doutel
  6.                                     2/12/91
  7.  
  8.    I have seen and used for a time several screen savers for Windows, 
  9.    and they were nice in varying degrees.  I have also been using Stars by 
  10.    David Stafford, a very nice program which paints moving stars on the 
  11.    DeskTop Window, behind all other windows on the screen.
  12.  
  13.    But what I wanted was a Screen Saver which would paint moving stars on a
  14.    full-screen FOREGROUND window!  I couldn't find one.  Ah, a project worthy
  15.    of my efforts, sufficiently esoteric to be diverting, educational and 
  16.    useful when completed!
  17.  
  18.  
  19.    REGISTRATION
  20.  
  21.       Of course, I, like just about all of us, am not adverse to a bit of 
  22.       remuneration, so I have opted to distribute StarSaver as SHAREWARE.
  23.       This means it isn't FREE.  If you find StarSaver of value for whatever 
  24.       reason and would like to stroke your ego, send me the $10.00 
  25.       registration fee.  Doing so will undoubtedly keep me VERY interested 
  26.       in enhancing (and saints forbid, fixing) StarSaver!  For information 
  27.       on where to send the Samolians, please print and fill out the 
  28.       registration form included below.
  29.  
  30.       Please feel free to pass StarSaver around to your friends and favorite
  31.       Bulletin Board Services, as long as you include with it this
  32.       documentation.  It would be best if you just used the original zip
  33.       file in which you received StarSaver.  The 2 files it contains are :
  34.  
  35.                       StarSave.exe    (the program itself)
  36.                       StarSave.txt    (This document)
  37.                       StarSave.hst    (development/maintenance history)
  38.  
  39.       I've had a lot of fun and learned a great deal writing this.  If
  40.       you would just like to rap about it, or anything else, for that matter, 
  41.       you can leave me messages on the SPIKE BBS at (801) 392-0331; it's a 
  42.       real nice board and I call it home, with many thanks to Eugene Morgan,
  43.       the SPIKE SysOp (I'm too poor for CompuServ or Genie, thanks to what
  44.       the SDK set me back!)  In any case, why not let me know what you think
  45.       of StarSaver?
  46.  
  47.       To register your copy of StarSaver, please send the form provided at
  48.       the bottom of this doccument along with $10.00 per copy being
  49.       registered to:
  50.       
  51.       Duane T. Doutel
  52.       5021 S. 600 West
  53.       Ogden, UT  84405
  54.  
  55.       Check or Money Order only, please!
  56.  
  57.    INSTALLATION
  58.  
  59.       Simple--install it in a Program Manager group as you would any other
  60.       Windows program, or place it in WIN.INI on the load= line, as follows:
  61.  
  62.                              load=c:\windows\ss.exe
  63.  
  64.       See your Windows User's Guide for more information on the "load="
  65.       command.
  66.  
  67.  
  68.    OPERATION
  69.  
  70.       Also simple!  When the StarSaver Icon is visible, clicking on it
  71.       produces the usual Windows System Menu, which has been modified to
  72.       suit my purposes.
  73.  
  74.       
  75.       ABOUT...
  76.          
  77.          Clicking here produces a typical Windows About Box.
  78.  
  79.       SETUP...
  80.  
  81.          Clicking here produces a dialog box from which you can alter the
  82.          default blanking interval, which is 1 minute.  Permissible values
  83.          range from 1 to 99 minutes.  It should be noted that the first 
  84.          time StarSaver is run and every time you modify the blanking 
  85.          interval, the new value is stored in WIN.INI in a [StarSave] 
  86.          section.
  87.  
  88.  
  89.  
  90.       SETUP (continued)
  91.  
  92.          It should be noted that NON-WINDOWS APPLICATIONS, i.e. DOS programs 
  93.          requiring a PIF, the DOS PROMPT, etc. running in full-screen mode
  94.          effectively cause the blanking interval to be much longer
  95.          than what the user might have set above.  In 386 Enhanced
  96.          Mode using the standard timeslicing and priority values, the
  97.          blanking interval appears to be multiplied by about a factor
  98.          of 6.  So if you have set a value of 3 minutes in the SETUP
  99.          dialog box, the screen will blank in about 18 minutes.  NON-
  100.          WINDOWS APPLICATIONS will be iconized if they are running in
  101.          full-screen mode before blanking occurs, so don't be
  102.          surprised when you have to click the application's icon to
  103.          resume your session.
  104.          
  105.       SUSPEND
  106.  
  107.          Clicking here will temporarily suspend blanking.  It remains 
  108.          suspended until you RESUME it or quit Windows.  You can tell
  109.          when StarSaver is suspended because the stars in the icon will
  110.          stop moving.  Conversely, you can tell StarSaver is active when
  111.          the stars in the icon are moving.
  112.  
  113.       The MOVE, CLOSE and SWITCH TO commands have the usual effect.
  114.  
  115.  
  116.    APPLICATION NOTES
  117.  
  118.       - Concerning the WINDOWS HOOK...
  119.  
  120.       This program incorporates a system-wide Windows message hook to monitor
  121.       User Activity.  Interestingly enough, Microsoft says that the code for
  122.       a Windows Hook MUST RESIDE in a DLL, and must have fixed code and data
  123.       segments.  As you other Windows programmers will probably notice, no
  124.       DLL has been used here.  However, I did do two things:  both code and
  125.       data are specified as PRELOAD MOVEABLE in the module definition file,
  126.       and the hook function is exported as per Microsoft's requirements.
  127.       You will note that the usual DISCARDABLE attribute has been omitted.
  128.  
  129.       This strategy works quite well, which should perhaps be a lesson to us
  130.       all; either Microsoft fibbed to us, or didn't tell us the whole truth
  131.       in the SDK documentation!
  132.  
  133.       It should also be noted that I found information (all of it needed)
  134.       scattered about in no less than 4 different places in the SDK document-
  135.       ation.  In short, Microsoft has done a VERY POOR JOB of organizing the
  136.       manuals!  The function descriptions give no "SEE ALSO"s, something
  137.       I have always found invaluable in the C compiler documentation.  And
  138.       to top it off, the function descriptions give no code fragments, also
  139.       invaluable!
  140.  
  141.  
  142.  
  143.  
  144.  
  145.                              Registration Form For
  146.                      StarSaver, a Screen Saver for Windows 
  147.                        3.0 and Above, By Duane T. Doutel
  148.  
  149.  
  150.  
  151.         
  152.           NAME ________________________________________
  153.  
  154.  
  155.        COMPANY ________________________________________
  156.  
  157.  
  158.        ADDRESS ________________________________________
  159.  
  160.  
  161.                ________________________________________
  162.  
  163.  
  164.           CITY __________________________ STATE ____ ZIP _______-____
  165.  
  166.  
  167.         SOFTWARE VERSION # (FROM ABOUT BOX)  ______
  168.  
  169.  
  170.         WHERE DID YOU OBTAIN YOUR COPY OF STARSAVER?
  171.  
  172.         ____________________________________________________________
  173.  
  174.         ____________________________________________________________
  175.  
  176.  
  177.         NUMBER OF COPIES BEING REGISTERED AT $10.00 PER COPY _____
  178.  
  179.  
  180.                                              AMOUNT ENCLOSED _____
  181.  
  182.  
  183.  
  184.